home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 23 / CU Amiga - Super CD-ROM 23 (June 1998).iso / CUCD / Magazine / C_Tutorial / Part-6 / IFF-library / MoviePRO / MoviePRO.doc < prev    next >
Encoding:
Text File  |  1992-08-07  |  6.4 KB  |  196 lines
  1.  
  2.           MoviePRO - an ANIM player for Movie and ANIM5 animations
  3.           --------------------------------------------------------
  4.  
  5.                          Version Beta 4, 14-Feb-91
  6.  
  7.  
  8.                       This program and iff.library by:
  9.  
  10.         Christian A. Weber, Bruggerweg 2, CH-8037 Zürich, SWITZERLAND
  11.  
  12.            Any suggestions or bug reports are welcome, e-mail to:
  13.  
  14.     UUCP:     {uunet|pyramid|rutgers}!cbmvax!cbmehq!cbmswi!mighty!chris
  15.     INTERNET: weber@amiga.physik.unizh.ch
  16.  
  17.  
  18.  
  19. THIS PROGRAM IS IN THE PUBLIC DOMAIN.  IT MAY BE FREELY DISTRUBUTED, COPIED
  20. AND USED FOR COMMERCIAL OR NON-COMMERCIAL PURPOSES. YOU ARE ALLOWED TO MAKE
  21. CHANGES TO THE SHOWIFF.* FILES AS LONG AS YOU CLEARLY MARK THE CHANGES.
  22.  
  23.  
  24. DISCLAIMER
  25.  
  26. THIS SOFTWARE IS PROVIDED "AS IS".
  27. NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY,
  28. RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION OF THIS SOFTWARE, AND
  29. ALL USE IS AT YOUR OWN RISK. YOU ALREADY KNEW THAT, DIDN'T YOU. THE AUTHOR
  30. ASSUMES NO RESPONSIBILITY OR LIABILITY WHATSOEVER WITH RESPECT TO YOUR USE
  31. OR INABILITY TO USE OF THIS SOFTWARE.
  32.  
  33.  
  34.                                     ***
  35.  
  36.  
  37. FEATURES
  38. --------
  39.  
  40. - Plays Movie animations (Created with Sculpt 3D/4D or DILBM/PILBM) and
  41.   ANIM5 animations (Videoscape, DPaint...).
  42.  
  43. - Runs from both Workbench and CLI, creates an AppIcon under Kickstart 2.x
  44.  
  45. - Uses double-buffering for best results
  46.  
  47. - Is fully multi-tasking compatible!
  48.  
  49.  
  50.  
  51. REQUIREMENTS
  52. ------------
  53.  
  54. MoviePRO requires the arp.library and, of course, the iff.library. These
  55. two files should be located in the LIBS: directory.
  56.  
  57. Currently, MoviePRO requires 10 KBytes of stack. Make sure you set this
  58. stack size in EVERY animation's icon, or a guru will visit you!
  59.  
  60. Note: This is only a beta release and has many bugs! Beware!
  61.  
  62.  
  63.  
  64. WORKBENCH USAGE
  65. ---------------
  66.  
  67.  
  68. Under Kickstart 1.3:
  69.  
  70.   Select all animations you wish to view while pressing the SHIFT key, then
  71.   double-click the MoviePRO icon.
  72.  
  73.   You can also set the animation's default tool to MoviePRO using WorkBench's
  74.   'Info' feature. You must set the stack size to at least 10K in the icon.
  75.   If you wish to display all the animations in a drawer, select the drawer,
  76.   and while depressing the SHIFT key, double-click the MoviePRO icon. This
  77.   works even with disk icons!
  78.   If a drawer or disk contains another drawer, the animations in that drawer
  79.   will also be displayed.
  80.  
  81.  
  82. Under Kickstart 2.x:
  83.  
  84.   Under Kickstart 2.x you have an additional possibility, which you may
  85.   prefer once you are familiar with Kickstart 2.x: You can put MoviePRO in
  86.   your WBStartup drawer. When you boot your Amiga, MoviePRO is automatically
  87.   started and creates an "AppIcon". This icon looks like any other icon, and
  88.   you can freely chose it's name and it's position (see below). But this
  89.   icon has an interesting feature: You can view an animation by simply
  90.   dragging the icon of that animation on MoviePRO's AppIcon. This works for
  91.   drawers and disks too, of course.
  92.   If you wish to remove the MoviePRO AppIcon, simply start MoviePRO again.
  93.  
  94.  
  95. Tool Types:
  96.  
  97.   MoviePRO understands several tool types. You can edit them using the
  98.   "Show Information" or "Info" commands from the Workbench menu. Here's
  99.   a list of the recognized tool types:
  100.  
  101.   ICONXPOS     Specifies the x coordinate of MoviePRO's AppIcon. This works
  102.                only under Kickstart 2.x and above.
  103.                Example: ICONXPOS=620
  104.  
  105.   ICONYPOS     Specifies the y coordinate of MoviePRO's AppIcon. This works
  106.                only under Kickstart 2.x and above.
  107.                Example: ICONYPOS=120
  108.  
  109.   ICONNAME     Specifies the name of MoviePRO's AppIcon (Only Kickstart 2.x).
  110.                Example: ICONNAME=Animation Player
  111.  
  112.   OPTIONS      Here you can specify several options, in the same format as
  113.                if you would enter them from CLI. Works under 1.3 too.
  114.                Example: OPTIONS=ALL LOOP 5 NOOVERSCAN
  115.  
  116.   TASKPRI      If you have a slow processor or a complex animation, MoviePRO
  117.                needs more processor time to display the animation in the
  118.                desired speed. If you set TASKPRI to some value higher than 0,
  119.                MoviePRO will run slightly faster. Note that in this case
  120.                you should not run any time-critical software (such as terminal
  121.                programs) while playing animations. TASKPRI can be set to any
  122.                value between -128 and 127.
  123.                Example: TASKPRI=50
  124.  
  125.  
  126.  
  127. CLI USAGE
  128. ---------
  129.  
  130.  
  131. The template is:
  132.  
  133. Patterns/...,ALL/s,C=CONTINUOUS/k,L=LOOP/k,T=TIMING/k,NO=NOOVERSCAN/s,V=VERBOSE/s
  134.  
  135. MoviePRO <patterns> [ALL] [CONTINUOUS num] [LOOP num] [TIMING jiffies]
  136.          [NOOVERSCAN]
  137.  
  138.  
  139. Example: MoviePRO Anim/* Sculpt/foo.anim CONTINUOUS 32000 TIMING 3
  140.  
  141.  
  142. patterns       can be any number of file names, directories or disk names.
  143.                All of the ARP wildcards can be used. (?,*,#?,...)
  144.  
  145. ALL            if this keyword is specified, animations in sub-directories
  146.                will also be shown.
  147.  
  148. CONTINUOUS n   This determines how many times the animation is displayed.
  149.  
  150. LOOP n         With LOOP you can specify how many times the animation is
  151.                played, but not continuously. This is for animations which
  152.                are not designed as endless-loop-animations.
  153.  
  154. TIMING n       specifies the delay between the frames of the animation, in
  155.                jiffies. Note that if you have a complex animation or a slow
  156.                processor, values lower than three (3) are not guaranteed to
  157.                give the desired results.
  158.  
  159. NOOVERSCAN     display all animations in the size of the Workbench screen, and
  160.                never in overscan. This is not very useful ;-)
  161.  
  162. VERBOSE        This is only for debugging and should never be used.
  163.  
  164.  
  165.  
  166. KEYS AND MOUSE-BUTTONS
  167. ----------------------
  168.  
  169. While an animation is displayed, you can press the following keys:
  170.  
  171.  
  172. LEFT MOUSE BUTTON
  173.  
  174.   Display the next animation. If there are no more animations to show,
  175.   MoviePRO closes its window and terminates.
  176.   If in AppIcon mode, MoviePRO closes its window and waits for new animations.
  177.  
  178.  
  179. RIGHT MOUSE BUTTON
  180.  
  181.   Abort immediately
  182.  
  183.  
  184. Ctrl-C (if the MoviePRO window or the CLI window is active)
  185.  
  186.   Abort immediately
  187.  
  188.  
  189. Ctrl-E (if the MoviePRO window or the CLI window is active)
  190.  
  191.   If you started MoviePRO from Workbench, ore enabled the "ALL" option from
  192.   CLI, pressing Ctrl-E will skip all animations in the current sub-directory,
  193.   and return to the parent-directory (like in the CLI "Dir" command).
  194.  
  195.  
  196.